home *** CD-ROM | disk | FTP | other *** search
/ MacTech 1 to 12 / MacTech-vol-1-12.toast / Source / MacTech® Magazine / Volume 10 - 1994 / 10.03 Mar 94 / Convert•Projects 1.0b2 / About Convert•Projects next >
Encoding:
Text File  |  1994-02-11  |  9.1 KB  |  236 lines  |  [TEXT/R*ch]
  1. (This file was created by BBEdit 2.5, a product of Bare Bones Software.
  2. It was written in Monaco 9, with four spaces per tab.)
  3.  
  4. This document is current as of -prerelease- version 1.0b2 of the
  5. software, written on February 11, 1994.
  6.  
  7. [Prerelease note: As of 1.0b2, the following limitations apply:
  8.     
  9. -    No one, including Metrowerks, knows what the signature for
  10.     MW Pascal/PPC will be. Therefore, the creator for PPC Pascal
  11.     projects is currently “xxxx”. You can change this with ResEdit,
  12.     or not at all (since MW Pascal will read the project, because
  13.     it has the correct file type).
  14.     
  15. -    The method for reading THINK C projects relies on launching
  16.     the THINK Project Manager, instructing it to open the project,
  17.     and then asking it for the list of files. It’s elaborate, and
  18.     needs to be exercised.
  19.     
  20. This version is a “public beta”; it is substantially feature-complete,
  21. and does what it says it does. It is in need of real field-testing, so
  22. if you have problems using it that aren’t covered here, or if you
  23. run into anomalous behavior, please contact us (preferably via e-mail).
  24.  
  25. Our plan is that version 1.0 of Convert•Projects will be delivered
  26. when version 1.0 of Code Warrior is delivered.
  27. ]
  28.  
  29. About Convert•Projects
  30. ----- ----------------
  31.  
  32. Convert•Projects is a utility which will read a THINK C or THINK Pascal
  33. product, and produce an equivalent (or nearly so) Code Warrior project.
  34. This is particularly useful for large projects, in which manually
  35. adding and segmenting the project would be tiresome or impractical.
  36.  
  37. Convert•Projects is -NOT- a source code converter. If your code uses
  38. non-portable constructs that aren’t supported by the Code Warrior
  39. compilers, you will need to manually change your code.
  40.  
  41. Convert•Projects does not modify the project documents you feed it,
  42. so you can continue to use them, should the need arise.
  43.  
  44. With Convert•Projects, you can convert THINK Pascal version 4.0 or
  45. later, and THINK C version 6.0 or later (including Symantec C++ 6.0)
  46. project documents.
  47.  
  48. How to Use Convert•Projects
  49. --- -- --- ----------------
  50.  
  51. Using Convert•Projects is easy - just drag & drop your project
  52. document(s) onto the Convert•Projects icon. Convert•Projects will read
  53. in your THINK C or THINK Pascal project document, locate and analyze the
  54. files, and produce a Code Warrior project. Subject to the preferences
  55. settings (see below), more than one project may be produced, e.g. one
  56. for 68K and one for PowerPC.
  57.  
  58. Some files cannot be used by Code Warrior. Specifically, Code Warrior
  59. cannot (and will never be able to) load THINK C project documents that
  60. are included as libraries (the ANSI libraries are an example of this);
  61. “standard” THINK C library files (created with “Build Library) likewise
  62. cannot be used by Code Warrior, nor can library files created in the MPW
  63. ".O" format (including THINK Pascal 3.0 or later library files).
  64. Convert•Projects will exclude these libraries when writing out the new
  65. project, and will advise you of the libraries that have been excluded.
  66. It’s up to you to reconstitute those libraries - if the source is
  67. available, then include the source directly in the Code Warrior project;
  68. otherwise, contact the library vendor for a version that works with Code
  69. Warrior.
  70.  
  71. Preferences Settings
  72. ----------- --------
  73.  
  74. Convert•Projects provides the following settings in its “Preferences” 
  75. dialog:
  76.  
  77. -    Emit 68K Project: If checked, Convert•Project will write out a
  78.                         project usable by the 68K versions of the
  79.                         Code Warrior environment.
  80.                         
  81. -    Emit PowerPC Project: If checked, Convert•Project will write out a
  82.                         project usable by the PowerPC versions of the
  83.                         Code Warrior environment.
  84.                         
  85. -    Remove Missing Files: If checked, Convert•Project will filter out
  86.                         files that it couldn’t locate when loading 
  87.                         the THINK-format project, and advise you
  88.                         of the files that have been filtered.
  89.                         
  90. -    Add Standard Libraries: If checked, standard libraries (ANSI.Lib for
  91.                         Code Warrior C & C++, MW/Runtime.Lib for Code Warrior
  92.                         Pascal) will be added to the created project.
  93.                         
  94. -    Add Toolbox Glue: If checked, toolbox glue (MacOS.Lib) will be added
  95.                         to the created project.
  96.  
  97. -    Ask for Project Name: If checked, Convert•Project will always ask you
  98.                         (via Standard File) to specify the name and location
  99.                         of each project that it writes out. Although this
  100.                         compromises the drag-and-drop-ness of the utility,
  101.                         it can occasionally be useful.
  102.  
  103. Limitations
  104. -----------
  105.  
  106. The following limitations apply when using Convert•Projects:
  107.  
  108. -    Convert•Projects uses the services of the THINK Project Manager to
  109.     determine the files and segmentation of a THINK C project. For this
  110.     reason, you’ll need enough memory so that Convert•Projects can launch
  111.     the THINK Project Manager.
  112.  
  113. -    Although it automates part of the conversion process, Convert•Projects
  114.     is -not- a “magic bullet” that will get you up and running with Code
  115.     Warrior in minutes. How long it takes you to get your programs ported
  116.     depends on the nature of your code.
  117.     
  118. -    Convert•Projects makes a reasonable effort to locate the files
  119.     specified in the input projects, and to write out projects such that
  120.     Code Warrior can readily find the source files. To help this process,
  121.     we recommend that you build the project you want to convert, so that
  122.     all source files’ locations can be determined. (If you’re using THINK
  123.     C, bring up the “Make...” dialog, turn off the “Quick Scan” check box,
  124.     and click the “Use Disk” button.)
  125.  
  126. -    Depending on the arrangement of your directory structures, you may need
  127.     to add some search paths to the Code Warrior project so that Code
  128.     Warrior can locate all of the files in that project.
  129.     
  130. -    Convert•Projects does not address the issue of resource files; Code
  131.     Warrior uses the same convention as THINK C for naming the project’s
  132.     resource file; you should make a duplicate of your resource file and
  133.     give it the correct name after converting your project.
  134.     
  135.  
  136. Miscellaneous Comments
  137. ------------- --------
  138.  
  139. -    Convert•Projects is free.
  140.  
  141. -    We plan to keep Convert•Projects up to date as necessary to accomodate
  142.     changes to Code Warrior. Therefore, if you have problems with
  143.     Convert•Projects, please let us know so that we can resolve them.
  144.     If Code Warrior has difficulty with a project that Convert•Projects
  145.     creates, or if Convert•Projects has difficulty processing your
  146.     projects, we definitely want to know about it.
  147.  
  148. -    Please note that we have no plans to turn Convert•Projects into a
  149.     source converter, and we cannot offer assistance with porting your code
  150.     to work with Code Warrior.
  151.     
  152. -    If you have questions or problems with Convert•Projects, please contact
  153.     us by one of the following means:
  154.     
  155.     Internet: bbedit@world.std.com
  156.     CIS: 73051,3255
  157.     AppleLink: BARE.BONES
  158.     Fax: (508) 651-7584
  159.     Phone: (508) 651-3561
  160.     Mail:    Bare Bones Software
  161.             c/o R. Siegel
  162.             1 Larkspur Way #4
  163.             Natick, MA 01760
  164.             
  165. Attributions
  166. ------------
  167.  
  168. Convert•Projects was written by Rich Siegel.
  169.  
  170. Convert•Projects is based on Drop•Shell, which was written by
  171. Leonard Rosenthol, Marshall Clow, and Stephan Somogyi.
  172.  
  173. Thanks to Greg Galanos and Berardino Baratta, both of Metrowerks,
  174. for their assistance.
  175.     
  176. Copyright & Distribution Information
  177. --------- - ------------ -----------
  178.  
  179. Convert•Projects is written by and copyright ©1994 Richard M. Siegel;
  180. all rights reserved.
  181.  
  182. This software may be redistributed under the following conditions:
  183.  
  184. -    Convert•Projects may not be sold, either by itself or in combination
  185.     with any other product, without the express written permission of
  186.     Richard M. Siegel.
  187.     
  188. -    This document and the Convert•Projects application must be distributed
  189.     together, in the same directory on a Finder-mountable volume, or in the
  190.     same compressed-file (e.g. StuffIt or Compact Pro) archive.
  191.     
  192. -    The Convert•Projects package may be freely posted to any BBS or
  193.     information service which charges its users for general connect and
  194.     downloading time; the package may -not- be posted to any BBS or
  195.     information service which will charge for the specific right to
  196.     download Convert•Projects.
  197.     
  198. -    Commercial publishers and distributors of CD-ROM software collections
  199.     may not include the Convert•Projects package without the express
  200.     written permission of Richard M. Siegel.
  201.  
  202. About Bare Bones Software
  203. ----- ---- ----- --------
  204.  
  205. Bare Bones Software, founded in May 1993, is the developer and publisher
  206. of the following software:
  207.  
  208. -    BBEdit 2.5, the best-of-class text editor for programmers, on-line
  209.     service users, and anyone else who needs to edit ASCII text files with
  210.     maximum performance and minimum fuss. BBEdit 2.5 features integration
  211.     with THINK C/Symantec C++ 6.0, THINK Reference, MPW ToolServer, and
  212.     support for THINK Pascal and Code Warrior projects, as well as an
  213.     assortment of unique and powerful features. Write for a free demo
  214.     disk.
  215.     
  216. -    BBEdit Lite, the popular freeware version of BBEdit.
  217.  
  218. -    Convert•Projects, a freeware utility to convert THINK C and THINK
  219.     Pascal project documents to Metrowerks Code Warrior format.
  220.     
  221. -    Drop•PS, a freeware PostScript™ downloader for network-connected
  222.     printers.
  223.  
  224. For additional information, contact us at one of these addresses:
  225.  
  226. Internet: bbedit@world.std.com
  227. CIS: 73051,3255
  228. AppleLink: BARE.BONES
  229. Fax: (508) 651-7584
  230. Phone: (508) 651-3561
  231. Mail:
  232.     Bare Bones Software
  233.     c/o R. Siegel
  234.     1 Larkspur Way #4
  235.     Natick, MA 01760
  236.